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Software License Agreement. ; | 

The information, data and programs supplied by Snow Micro Systems 
Inc, are proprietary. This software license is granted for the 

use of the software in one microcomputer location . Programs may not 
be copied or reproduced in any form for resale or distribution to 
users other than the original licensee without prior permigsion 
from Snow Micro Systems Inc. ` | 


Limited Warranty | | o 
Snow Micro Systems Inc. warrants all diskettes tọ be free of errors 
at the time of shipment and will replace any dafective diskettes 
within 30 days of the time of purchase by the original licensee. 
This warranty does not cover any obvious abuse of the. disc. 


The Licensee acknowledges that -Snow Micro Systems Inc. is not 
liable for anything resulting from the loss of data resulting from 
the use of this software. 


Snow Micro Systems Inc. 
P.O. Box 1704 

Silver Spring, 

Md, 20902. 


Tel (301) 622-1931 
622 2194 
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0. Introduction u Š 


The Snow Micro Systems MAILER allows you to create, update, and dwiete 
name and address records; print envelopes; print malling labels; and 


assign selection codes for flexible output of easily defined classes of. 


records. Its file structure Is designed for very compact storage of 
data on your disks and for rapid access of individual records In 
alphabetical order. Except at the primary level, most commands are 
single keystroke for quick operatlon and convenience. 


Commands available at the primary (system) level are: 


MAINT - add, delete, and update name/address records 
PRINT - output file in alphabetical order | 

ZIPSORT = sort In zipcode order ana print labels 

SETUP - initialize 


MAILFIX = recover from fille errors; oe 
Each of these commands will load a major module of the system. Within 
each module, several addittonal commands are avilable. The screen 
display provides clear and explicit prompting about what is required 
for input. The following Instructions contain more hints about how. to 
use the system effectively, but the best way to learn how is to try. 


Limitations 


Mailer requires a North Star DOS release 4 or later, 28K of RAM, a 
printer and a video display or terminal. With a double density 2 drive 
system and 48K RAM, you can keep the MAILER programs on one disk and 
maintain about 1000 names and addresses on another. A minimum system 


with a single drive is limited to about 125 records, but with 32K of 


RAM you may be able to store a 300 name file on a single density disk 
that 


1. Using MAINT. 


This module Is ved to A records In your name and address file. 
The available commands from this program are: 

Get -~ a record from the file, and display it. You may then update it, 
delete it, or get the next entry. Ce ' | 
Update = any record : 

Delete - any record 

Add - a new record 

Quit © and return to the primary command level. 


These are single key stroke commands, requiring only the first letter 


of the command word - eithér upper or loner case, 


You. may respond to the question "which name?" with one or more letters 
of the last name plus the first name, a maximum of eight. If a unique 


match is found, that record will be displayed. Otherwise, you will see 


all the names that match the letters you keyed In. You can see all 
those that begin with B by entertng this single letter, for example, 
Each name will be displayed with its number. If you don't want to see 
any of those records, enter 0 In response to ‘Which number?! 


When creating or updating an entry, you can correct a mistake on tha. 
previous line by entering the ‘up arrow' followed by the RETURN key. 
If you hit just RETURN, the existing data on that ltne will be 
PERERIN E 


In creating or updating an entry, you can use the SECOND NAME flald for 
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a firm name, or part of a 4& line foreign address. 


E E E WARNING” {!')] « & & & 
IF YOU EXIT FROM MAINT WITHOUT Pane THE QUIT COMMAND, ERRORS MAY 
APPEAR IN YOUR DATA FILES. 


2. Ustng the selection code feature. 


Each name/address record In your fille has space for a 4& character | 
seletion code, which consists of 4& blanks till you put something more 
interesting-In. Any character that appears on your keyboard can be 
used, and thls code can be used to determine which records are selected 
by ZIPSORT and PRINT. Suppose you are using MAILER to keep track of 
your customers. You might use the first position to record the 
customers approximate sales volume (say the log of annual sales so 6 
represents a million), the second position for the month of your last 
call, the third for his status on a prospect scale of 1 (cool) to - 


l (hot), and the last for the month of-his last order. 


Now suppose you want to send a natte out to al the customers that: 
(1) you called on during July through December, (2) do more than a 
million a year in business and (3) are at least luke warm prospects, 


First enter ZIPSORT command [n at the primary level. When that program 


asks you If you want to use the selection code feature, you naturally 
respond YES (actually, y will do). The program then asks you to enter 


= the codes to match In position 1. You enter 6789 (corresponding to 


sales volumes of 1 million, 10 million, 100 million and 1 biliton). 
The codes to match In the second position are 789ABC corresponding to. 
the last 6 months of the year; In the third position 345 for luke warm 
through red hot prospect; and carrlage return for position 4 pecause 


you don't care about when he last ordered, 


As another example, if you want to send follow up letters to all the 


prospects you called on In March, you htt the carriage return in | 


response to the first three code match questions, then enter 6 as the 
code to match in position 4. 


With 96 ASCII characters to chose from in each of 4 positions, you can 
define about 8,940,000 different codes, which should be enough for many 
applications. The selection codes can also be used with PRINT to 


produce a listing of that part of the file that you want to see, 


3. Using PRINT. a à 


PRINT, a primary level command, ts used for printing ltstings of the 
file and for printing envelopes with your return address. In listing 


the file, you will be asked for the first name to list. Hit RETURN to | 
begin at the start of the file, otherwise use the same proceedure ag In 


MAINT to access the first record you want listed. Next, you will be 
asked for the number of records to list. Any positive number may be 
entered. Selection codes. can be used to limit the output to those 
records you want to see this time. 


You may chose from among 5 formats for printing records from the file. 
Formats 1 and 2 print the entire record. Format 1 uses 2 lines with no 
Spaces between records (your printer should print at least 80 character 


ets, 
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lines for this to be useful). Format 2 `uses 4 Iines per record plus a 


Space between, and Is a useful way to display records on your screen, 
Formats 3,4 and 5 use one line and print only part of the record. | 
Format 3 shows name and address only, Format 4 lists name and phone 
number (set printer tab at location 40 first), and Format 5 displays 
Name, remarks and selection code. >` | 


Format 6 Is used to print envelopes one at a time. After each one is 
printed, you wlll be asked if you want to print the next (in 


alphabetical order). Before printing, the record will be displayed on 


the screen, and you will be asked-if you want to print that name and 
address. This way, you can rapidly scan the file In alphabetical order 
and print envelopes selectively. 


4. Using ZIPSORT. Ka 


This command is used to print mailing labels in zipcode order., 
Selection codes may be used to print only those records you want. You 


must specify the smallest and largest zipcode to be used. These 


features allow your malling to be almed at particular types of people 
within a particular geographic area. 2ZIPSORT will read the entire file 
and print the labels for only the records within the zipcode range and 
matching the selecttion codes (if you use them). 


5, Using SETUP. 


Thts command Is used to setup the MAILER system to fit your screen and 
printer, to create and name disk files on which to store your My 
name/address records, and to store the return address to be printed on 
envelopes. This information is stored on the file named MAILCTL, 
SETUPS will ask a serles of questions, and wlll always display the 


-> current information stored on MAILCTL,. To leave an entry unchanged, 


Just hit RETURN. As usual, y or n will suffice for YES and NO. The 


. meaning of most of the input prompting is pretty clear, so this 


discussion ts brief. 


Suppose you have a 2 drive system, and want to keep your name/address _ 


flle on a separate disk on drive #2, while your program disk Is on 
drive #1, Then, in response to the prompt Drive # for program disk, 
you obviously enter 1. Suppose you want to use the name MLIST for your 


oe file. Then, you enter MLIST,2 for the Name, drive # of 
‘the file. a : 


The next option you have is to specify thè mailing label size and 


spacing: the width of the label (in printed characters), the number of 
labels across the page, the number of blanks between Tàbels | 
(horizontally), and also the number of blank lines between labels 


(vertically), assuming 4 lines will be printed on each label. You will 


need a ruler and the knowledge of how many characters per Inch and 


lines per inch your printer puts out in order to figure out these 
answers, 


For example, suppose your labels come 3 across the page and are 3.5 
inches by .9 inches with a .2 inch horizontal space and a .1 inch 
vertica] space between them. If your printer prints 10 characters to 
the Inch and 6 lines to the Inch, you should specify 35 characters as 
the width of your labels with 2 blanks between, and 2 blank lines 
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between labels. : E 


The next option you have is to update the specifications of you screen 
and printer, Including the width of a line on each and the number of 
lines per page (or screen). You can specify the command code to CLEAR 
SCREEN on your terminal, and the TAB and FORM FEED (top of new page) 
command codes for your printer. Some terminals and printers want a 
single character code, others want multiple characters, so the first 
thing you are asked In each case Is the number of characters in the 


code, and then the ASCII values of the code Itself. The standard values 


for these codes are 12 for CLEAR SCREEN and FORM FEED and 9 for TAB. 
If your printer lacks tab or form feed controls, enter 0 for those 
codes. | 


Buss ne . 
The return address to be printed on your envelopes can be updated by 
SETUP. You are limited to 3 lines of. 40 characters each, 


You will be asked If MAILCTL Is to be written to the same disk It was 
read from. If you answer N, you can specify where you want It. You 
might as well keep [It on the program disk, unless you have | a 
severaldmiling lists, each on Its own disk and with a different name. 
In this case, you should keep a copy of MAILCTL on each malling list 


disk, 


Finally, you will be asked If you want to create a new file for your. 
mailing list. If you do, be sure that you have enough space on the 
disk In the drive you specify. Allow about 6 blocks for each 10. 


name/address records. 


6. Using MAILFIX. 


To use this program effectively, you just know a little about the | | 
MAILER file structure. Your name/address records are stored In a file 
we will. call MLIST for this discussion, Records are stored on MLIST In 
the order they were created (or updated), They are retrieved searching 
a pointer file, *MLIST. (The name of the pointer file Is * plus the 
name of the mailing list file). Records im *MLIST consist of an 8 | 
character alphabetic key (bullt from the last name of the corresponding 
record In MLIST plus the first name If needed) and the position in | 
MLIST of the main record. *MLIST Is read irto the computer memory 

where It is kept In alphabetic order as MLIST is altered, and written 
to disk when you Quit MAINT. | Í 


The records in MLIST are of variable length. When an update results in 


a longer record, the new version is written at the end of the file, and 


the old record is marked as deleted by writing the character ")" in the 
first position In the record. If the new record is shorter, It Is 
padded out with blanks to use up all the space of the original, and 


stored back in the same spot. In either event, the MAINT program keeps 


up to date a count of the space taken up by these blanks and by deleted 
records, and this Is reported as % garbage every time you use the MAINT 
command, As you begin to fill up your MLIST fille and garbage begins to 
accumulate in It, you may want to create a new garbage free version 
which will take less space. MAILFIX can do tt for you. | 


Another use of MAILFIX i$ to escape from the worst consequences of 
Murphy's law :"if something can go wrong, sooner or later It wil", 
Someday an error will creep into either your MLIST flle or the polnter 
file, *MLIST. The first line of defense against Murphy's law ts: 
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ke MAKE FREQUENT BACK-UP COPIES OF YOUR"WORKING DISK «s 


MAILFIX operates In 3 modes: (1) Read the name/address file and make a 
new polnter file, (2) Read the name/address file, and write only 
active records (less excess trailing blanks) to a new file while 
creating a new pointer file, and (3) Same as (2) but also check each 
fleld of each record for length errors. | 


Whenever you use options 2 or 3, you should write the new verston of 


MLIST on a new disk. If you have only a single drive system, use a new. 


file on the same disk. If you can't do that, at least make a back up 
disk before using MAILFIX. If your files are În good shape, but you 
merely want to squeeze out the garbage, then use option 2. 


ZIPSORT reads the entire MLIST file and does not use the pointer file 
*MLIST, while MAINT and PRINT use *MLIST. So If ZIPSORT works while 
MAINT and PRINT produce error messages, the chances are that the 
problem ts in the *MLIST file. Under these circumstances, use option 1 
of MAILFIX and replace the old version of *MLIST with the new one, 


On the other hand, If ZIPSORT produces flle error messages while most 
of the records on MLIST can be accessed by MAINT, the chances are that 


one or records in MLIST contain errors. In case of such a disaster, you 


can of course make a copy of your last back-up disk and use that as 
your working file. If, however, you have not made a back-up disk 
lately, of you discover that It, too contalns errors, then you will 
need the advanced features of MAILFIX, Including option 3. 


MAILFIX first asks for the option number, then the fille name and disk 


drive of your name/address file. (Assume the answer Is MLIST,1.) If- 
you have specified options 2 or 3 the next question is the name and 
drive number of the new name/address fille to which the good records 


from MLIST will be copied. (Assume this is MLIST,2.) The next question 
Is how many records are to be. read. Enter the number of active records © 


In MLIST. Next question is ‘Read and write at start of file?', to which 
you should respond Y, unless you have a very good reason for some other 
answer. (The start of the fille of name/address records Is position 20; 
the earlier positions are occupied by header information.) m 


As each record Is read, the screen display reports the number of the 
record, the position of the record start in MLIST,1, the record length 
as read, the position of the start of the record in MLIST,2, the 


alphabetic key as constructed for *MLIST,2, and the length of the’ 


record as written in MLIST,2. If option 1 Its used, the data relating 
to MLIST,2 is, of course, omitted from this output. If an error is 
detected In reading a record, this fact Is reported, and you are asked 
if you want to quit. If you answer Y, then the file *MLIST,2 will be 
written and you are done, 


(Step A) Suppose, however, that you are only partway through reading 
MLIST,1 and wish to bypass the bad record and read the rest of the file 
Onto MLIST,2. If you answer N, the program opens up a visible window 
Into MLIST,1 so you can find the next good record. The program reads a 
byte at a tle from MLIST,1 and displays each byte. Those that decode 
to printable characters (have decimal values between 32 and 95) are 
displayed in that form. Qtherwise, the decimal value Is displayed 
within brackets. The Individual name/address records of MLIST are _ 
stored as string variables, so that the first byte of each has decimal 
value 3 (the North Star convention for strings shorter than 256 bytes), 
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Since the obiect of the game ts to find the’ start of the next good 


record In MLIST,1, the program stops reading and reports 'Posstble 
record start at NNNN' when a byte of: decimal value 3 ts found, 


(Step B) You are now me if you want to extend the window. if you 
enter Y, the program goes back to Step A. If you enter N, the program 
goes to Step C and asks if you want to move the window start, that Is, 
the left edge of the window. If you answer Y, you will be. asked the 
obvious question 'Where to?'. Enter the numerical value of the position 
In. MLIST,1 where you want to start reading bytes. For example, If you 
think a possible record start at NNNN' fs the beginning of a good 
record, move the window start to NNNN. The program the returns to Step 
A. If you answer N in Step C the program goes to Step D and asks 'Set 
read pointer to window start?'. If. you are sure that the left edge of 
the window fs at the start of the next good record, you enter Y., The 
program than returns to reading records from MLIST,1 and writtng them 
onto MLIST,2. 


If- you answer N În Step D, the program asks If. you want to quit. The Y 
answer causes *MLIST,2 to be written, while the N answer returns the 
program to Step A. : 


To help you Identify a good record when you see one, you should know 


about the record layout: | | 

Byte 0 - Valus #3 (first overhead byte In N.S. disk record) 
Byte l= Value = length of string (Second overhead byte) 
Bytes 2-6 Zipcode 


Bytes 7°10 Selection codestes 12-12+4+n Last name 


Byte 11 Length of last name (n) 

Bytes 12-124+n Last name | 

The rest of the record consists of similar varlable- “length fields. The 
rest byte Is the length of the data In the field, 


A. ‘record display from MAILFIX might look like this (with the the 
various messages and replies shown): i 
K20004z00 (5)Chimp(4)Zbig(3) 

POSSIBLE RECORD START AT 1681 EXTEND WINDOW? y 

Mr.(0)(21)5000 Connecticut Ave.(10)Washington(2)DC(3) 

POSSIBLE RECORD START AT 1722 EXTEND WINDOW? y 
202(8)600-9090(0)(3) 

POSSIBLE RECORD. START AT 1737 EXTEND WINDOW? n 

MOVE WINDOW START? n 


SET READ POINTER TO WINDOW START? y 


The program will then read the record just displayed ani write it onto 
MLIST,2. Note that two fields of length x3 are interpreted as possible 


new. records, and that there are two empty fields (of length zero), The. 


first character displayed, K, has decimal value 75, the ener of the 


record, 


You cannot use MAILFIX to reconstruct a record that contains errors, 
but you can use It to skip over a bad record in MLIST,1 and copy the 
rest of the good ones to MLIST,2. Be sure your new working file is 
error free by running ZIPSORT and by printing the entire file In 
alphabetical order using PRINT. Only then should you destroy your old 
version ana make a backup disk of the new one. 


N 


